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Welcome to the first KAOS newsletter for 1983, We can't promise you an 
exciting year full of surprises as we never know from one month to the next 
what's going to happen, We just muddle along, somehow there always seems to be 
something new and interesting to write about, hopefully this will continue for 
this year. 


Please remember that membership fees are now due, The mailing list will be 
updated on the 16th February and if we haven't received your fees by that date 
you will not receive the February newsletter, If you intend to stay in KAOS we 
would appreciate receiving your fees before the 16th as it is annoying to remove 
a name from the mailing list and then have to put it back a few days later, 
Marian Anear will join me in thanking you for your co-operation, 


You may be aware that George (COMP-SOFT) has gone to Greece for a holiday, 
Some people were afraid that while he was there he would either get married or 
be conscripted into the Greek army. We have just received word that our fears 
were groundless, because of all the gym work he did before he left he was able 
to out-run the girls, and the army didn't want him: he failed the IQ test! 


A member has suggested that we put area codes on all phone numbers, we are 
doing it in the newsletter and the heading on the front page will be changed as 
soon as possible, at the moment all these numbers have an 03 prefix. If you are 
writing material for the newsletter and want your phone number included, please 
put your area code on your number, 


The next meeting will be at 2pm on Sunday 30th January 1983 at the Essendon 
Primary School, which is on the corner of Raleigh and Nicholson Streets, 
Essendon. As the children will still be on holidays the school will not be open 
untill lpm. 


Items for the February newsletter must be received by the 13th February 
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SMART LISTER 
by Kerry Lourash 


Since OSI ROM BASIC allows only seventy-two characters in a BASIC line, it 
is often necessary to write code with no spaces between characters, which tends 
to produce illegible listings, SMART LISTER is a utility that operates as an 
improved LIST command, inserting spaces at strategic places in the BASIC lines. 
it lists, in order to make the lines more legible, 


I was impressed when I saw the APPLE's method of program storage, It 
removes non-significant spaces from BASIC lines when they are tokenized and 
adds extra spaces when the lines are listed, On closer inspection, however, 
the APPLE system is not completely satisfactory, It prints a space before and 
after each token ina line, There's nothing REALLY wrong with this method; it 
1s simple and effective, 


Like all programers, if I was going to create a system, I was going to do 
it my way. An APPLE listing is just a bit too spread out for my taste; I don't 
feel arithmetric operators (-, -, /, *) should be segregated by spaces. Also, 
in the APPLE system, when two keywords are adjacent, a double space separates 
them, APPLE doesn't check to see if the previous character was a space before 
printing another space, Since OSI doesn't screen spaces on input, I wanted to 
include a redundant-space check in my system. 


HERE ARE THE RULES OF SMART LISTER: 


1. Don't add redundant spaces. 

2. Insert a space after every statement (colon), 

3. Insert a space after every keyword with a token equal or less than the 
STEP token, 

4, Insert a space before the TO, THEN, AND, STEP, and OR keywords. 


SMART LISTER can be called as a USR routine, With X=USR(X) installed as 
line zero of a program, LISTER can be called with a RUN command, Higher line 
numbers will not be executed, since LISTER exits to the immediate mode after 
1ts work is done, The routine can be installed in any part of memory without 
modification of its code, LISTER occupies less than 300 bytes, 


To use the routine, simply call LISTER and reply to the lower-case "list" 
prompt as you would type a list command, 


Now what we need is an input filter to screen out spaces ina line before 
it is tokenized, Better yet, a space-gobbler program that deletes all 
unnecessary spaces from a program in memory. Don't count on me, though; look 


how long it, took me to get around to developing SMART LISTER! 
Next page please 
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FOR SALE 


MISCELLANEOUS ASSEMBLED and TESTED TASKER BUSS BOARDS, including RAM cards 
$50, Floppy Disk card $35, Mother Board $50. 


5V 10amp POWER SUPPLY, including all leads, nad 12V 5amp for 5 1/4" floppy disk 
drives. In case with keyswitch etc. $100.00 


MODEL 15 TELETYPE, including manual, excellent condition, Has worked with 
Superboard, $70.00 


All prices are negotiable. I also service and repair most OSI systems at very 
reasonable rates, Paul Dodd 
2 


] ; *SMART LISTER* 62 JSR CHRGET 123 BEQ S.TEST 

2 ; by K.V.L. 63 JSR EVAL 124 CMP #THEN 

3 *MOVEABLE CODE 64 BNE EXIT 125 BEQ S.TEST 

4 : ROM DISK 65 Ll LDA POKER 126 CMP #AND. 

5 BPTR = $C3 $C7 66 ORA POKER+1 127 BEQ $.°%EST 

6 BUFFER = #13 S1B 67 BNE START 128 CMP #OR ' 

7 CHRGET = SOOBC SCO 68 LDA #SFF 129 BEQ S.TEST 

8 CHRGOT = $00C2 SC6 69 STA POKER 130 CMP #STEP 

9 CHRSAV- = $13 S1B 70 STA POKER+1] 131 BNE NOSPC 

10 CTRLC = $A629 $0819 71 START LDY #1 132 S.TEST LDA #SPACE 

11 EVAL = SA77F $096C 72 STY QUOFLG 133 CMP CHRSAV 

12 FINLIN SA432 $0633 73 LDA (VARPTR),Y 134 BEQ NOSPC 

13 INPUT = $A357 $0558 74 BEQ EXIT 135 STA CHRSAV 

14 LF:CR = SA86C $0A73 75 JSR CTRLC 136 JSR OUTPUT 

15 NUMPRT = SBY5E $1CDC 76 JSR LF:CR 137. NOSPC LDA TOKSAV 

16 OKAY = $A274 $0474 77 INY 138 SEC 

17 OUTPUT = SA8E5 SOAEE 78 LDA (VARPTR),Y 139 SBC #S7F 

18 POKER = $11 $19 79 TAX 140 TAX 

19 QUOFLG = $60 $10 80 INY 141 STY YSAVE 

20 SPACE = $20 $20 81 LDA (VARPTR) ,Y 142 LDY #SFF 

2) TOKSAV = $14 $1C 82 CMP POKER+1 143 NEXTOK DEX 

22 TOKTBL = SA084 $0284 83 BNE L2 144 BEQ L5 

23 VARPTR = SAA SAC 84 CPX POKER 145 NEXCHR INY 

24 YSAVE = $97 $96 85 BEQ L3 146 LDA TOKTBL,Y 

25 : 86 =L2 BCS EXIT | 147 BPL NEXCHR 

26 ;** TOKEN LABLES ** 87 L3 STY YSAVE 148 BMI NEXTOK 

27 AND. = S48 88 JSR NUMPRT 149 L5 INY 

28 OR = SA9 89 LDY YSAVE 150 LDA TOKTBL,Y 

29 STEP = SA2 90 LDA #SPACE 151 BMI ENDSPC 

30 THEN = SAO y1 L4 JSR OUTPUT 152 JSR OUTPUT 

31 TO = $9D 92 STA CHRSAV 153 BNE LS 

32 : 93 CMP #'" 154 ; 

33 * = $6800 94 BNE L6 155 COLON CMP #!': 

34 : 95 LDA QUOFLG 156 BNE L4& 

35 ;** 'LIST' PROMPT 96 EOR #$FF 157 BIT QUOFLG 

36 LDA #'1 97 STA QUOFLG 158 BMI L4& 

37 JSR OUTPUT 98 L6 INY 159 JSR OUTPUT 

38 LDA #'i 99 LDA (VARPTR),Y 160 INY 

39 JSR OUTPUT 100 BNE CHAR 161 LDA (VARPTR),Y 

40 LDA #'s 101 TAY 162 CMP #SPACE 

41 JSR OUTPUT 102 LDA (VARPTR),Y 163 BEQ BRNCH2 

42 LDA #'t 103 TAX 164 DEY 

43 JSR OUTPUT 104 INY 165 ADDSPC LDA #SPACE 

44 ;** INPUT LINE NOS. 105 LDA (VARPTR),Y 166 BNE BRNCH3 

45 JSR INPUT 106 STX VARPTR-. 167 ; 

46 ;** STORE LINE NOS, 107 STA VARPTR+1 168 ENDSPC AND #S7F 

47 LDA #BUFFER 108 BNE START 169 JSR OUTPUT 

48 STA BPTR 109 EXIT LDX #S$FE 170 LDY YSAVE 

49 LDA #0 110 TXS 171 INY 

50 STA BPTR+1] 111 JMP OKAY 172 LDA (VARPTR) ,Y 

51 JSR CHRGOT VI2- <3 173 DEY 

52 BCC GETNUM 113  BRNCH1 BEQ L6 174 CMP #SPACE 

53 BEQ GETNUM 114 BRNCH2 BEQ L& 175 BEQ BRNCH1 

54 CMP #'- 115 BRNCH3 BNE L4 176 LDA TOKSAV 

55 BNE EXIT 116 BRANCH BNE L6 177 CMP #STEP+1 

56 o€ETNUM JSR EVAL ll7 3 _ 178 BCC ADDSPC 

57 JSR FINLIN 118 CHAR BPL COLON 179 CMP #AND. 

58 JSR CHRGOT 119 BIT QUOFLG 180 BEQ ADDSPC 

59 BEQ Ll 120 BMI L4 | 181 CMP #OR 

60 CMP #'- 121 TOKEN STA TOKSAV 182 BEQ ADDSPC 

61 BNE EXIT 122 CMP #TO 183 BNE BRANCH 
FOR SALE 


POWER SUPPLY EX OSI C2P 110V AC input 4.5A @ 5V dc 


110V 75mm cooling fan ex OSI C2P $17.00 


240V/110V 1OOVA transformer in case $15.00 
(Would be sent surface mail due to weight) 


$30.00 


High Speed Cassette Interface, Will run at 1200 baud and connects to system 
via a PIA, VIA or similar. Connect one or two cassette players with motors 
under remote control if desired. Driver routine for 6800 CPU available which 
may assist 6502 users to interface. Documentation included, $90.00 


For all these items contact Wayne Geary, 


3 


Soperboare! 


Newsletter of the Ohio Superboard User Group, 146 York Street, Nundah, 4012. 


SOFTWARE REVIEW - OST Invaders. 


This is OSI's version of the famous (some would say notorious) Space Invaders 
program which started the video games craze. The program is a mix of Basic and 
M/C programming. The Basic part gives game playing information and keeps the 
scores for each level of play, while the M/C part controls the game , screen 
and keyboard. The invaders themselves show very creative programming. By 
combining characters 242 through 247, a fascinating little creature with 
flapping "arms" is produced. 


- Rows of invaders march across the screen, bombing your gun and shields while 
you dodge and blaze away. Every time a row reaches one side of the screen, all 
the invaders drop down a level. The object of the game is to shoot them all 
before one lands. You gain one gun every time you clear a screenful. Level of 
play, the highest score at that level, and present score are continually 
updated on the screen above the invaders - not that you have much time to look 
during a game. As you thin the ranks out, the remaining invaders move faster 
and are harder to hit. The last invader is a regular little rocket! 


There are fifteen levels of play - from impossibly fast to very slow. Practical 
limits are from 10 to about 3, depending on your reflexes. 


To sum up — the best game of this type that I have seen. Excellent in every 
aspect. Highly recommended. Only available for the CIP as far as I know. 


OSI Invaders is in the OSUG Library at the normal postage rates for Members. 


GO INTO ORBIT 


10 FOR A=1T0O24:PRINT: NEXT: P2=6. 28318: C=53743: B=32:P=232 

20 R=9;:12=.4 

30 FOR A=I TO P2 STEP I:X=INT(R*COS(A)):Y=INT(R*SIN(A) )*B 

40 POKE C+X+Y,P:FOR T=0 TO 10:NEXT:POKE C+X+Y,B:NEXT:GOTO 30 


For a 64 character screen, add L=B*2 at the end of line 10 and change the B 
in line 30 to L. Also change C to an address at the centre of your screen. 
Variables:-— P2 = 2 x PI, R= radius of orbit 
I= interval between plots, T= time delay 


QUICKPRINTER II INTERFACE by John Olding 


Some time ago, Tandy offered the Quickprinter for sale at a very reasonable 
price. This machine has its limitations, printing on aluminised paper that 
is only three inches wide which makes it useless for wordprocessing applications 
but OK for program listings for error correction etc. The Quickprinter is 
easily connected to the Superboard. You need to have the RS-232 area populated 
but no negative swing is required. You also need 600 Baud. Switch to 1 MHz. 

POKE 13,9:POKE 517,1:POKE 518,220:POKE 15,31 


The connections are as shown at right:- RIMTER 
J3 Piv | P 
Viewed from end of plug to printer. | — \ Din 
J3 PIN a PLUG 


— SUPERBOARD — 


COMPETITION 


Just a short reminder that the programming competition closes on February 
12th, 1983. Your entry form was included in the last KAOS Newsletter. 


BOOK REVIEW by Bernce Wrees. 


Microcomputer Design and Troubleshooting is 350 pages in soft cover, 
written by Eugene Zumchak and published by Howard Sams. 


The book is hardware oriented, explaining the making of a minimum cost 

6502 development system which could be used to produce dedicated controllers 
etc. The application of the Aim, Kim, and Sym systems to these tasks is also 
explored. A versatile Eprom programmer is described, complete with M/C 
software. 

Various chapters cover timing, clocks, gate delays, bus control,buffering, 
address decoding, multiplexed keyboards, programmable ports, and serial and 
parallel input/output. There is an informative chapter on servicing 
microprocessor systems, static and dynamic board testing and emulation. 


To summarise: If you need easily readable and very practical information 
on design, expansion, or modification of 6502 systems hardware, then this 
book will suit. Recommended price is $22.75 


COMPUTERS IN THE SCHOOL- A STUDENT'S VIEW by Ross Baker. 


In September, 1980, Mitchelton High School in Queensland conducted a 
walk-a-thon to raise money for a computer system. The school purchased a 
PDP 11/03 system and a CIP. A special room was set aside as a computer 
room and air conditioned. The PDP 11/03 has as peripherals, a VDU, printer, 
card reader and dual disk drives. The card reader allows many students' 
programs to be checked quickly, and the programming language can be Cobol, 
Fortran, Pascal or Basic. The mini-computer is used mainly for school 
administration work, and prints out students' report cards at the end of 
each semester. 


There are now six C1IP's available for the use of students, and the computer 
room is open before school from 8 am to 8.45 am, during the lunch break, 
and after school until 4 pm. Students may book a computer twice each week, 
and any idle machines are available on a first come, first served basis. 


Most of the machines are now fitted with switch selectable Baud and CPU 
rates, and with components added to the RS-232 interface, access to the 

PDP 11's printer and disk storage is possible. A single disk drive and 
expansion interface is expected to be fitted to our latest series II CIP 
soon. 

For one period each week, grade 10 students have a computer awareness class. 
The course is structured to take some of the mystery out of computing. 
Subjects covered include the history of computing, job prospects in the 
computer field, programming in Basic, and use of the printer and CIP. 


Grade 11 and 12 students have programming integrated into the maths 1 and 

2 units. One example of an assignment was to write a Basic program to print 
the height and velocity of an object thrown into the air. A later addition 
to the assignment was to plot the positions at 1 second intervals using 
TAB statements. 


Use of computers, and computer education in schools would appear to have 
a bright future. 


Next month, a review of BASIC 5, a chip with spectacular graphics functions. 


5 Ed Richardsun. 


Queens land User Group Meeting. 


Date: 12.12.82 Time: 54 hours Attendance: 24 Computers: 7 


For the first time ever, disk systems outnumbered cassette based 
systems. Paul Brodie had his Shugart and Tasker Bus on display after much 
work on the system by himself and Robin Wells. A demo had been planned to 
show off the free modems, but it went awry, and more head scratching was in 
order. | 

Brendan Vowles had his Rabble and Tasan boards for inspection but . 
couldn't give an active demo of the Rabble board functions. Most of the 
members were impressed by the finish of the Rabble board and it now seems 
to be the best way to go for expansion to disk. 


David Hill offered printouts of any member's programs on his ICL 
printer, and spent most of the afternoon with it chattering happily. 


Bill Simpson demonstrated some of the software developed for and by 
his school and himself with emphasis on education. 


Robin Wells had some interesting M/C games simulating alien attacks on 
your spacecraft as seen from the cockpit. A lot of practice was needed to 
master the controls. 

' Alan Calvert showed us his Looky Video case which was very roomy and 
seemed excellent value for money. Every conceivable cut out has been made 
on the back panel to suit the keenest hardware modifier. 


Bernie Wills had converted Sargon II Chess to use the chess characters 
programmed into his enhanced character set. Everyone agreed that at last we 
had a superb chess game and superb graphics - no mental character conversions 
being required to play the game on the screen. Bernie offered to supply the 
sargon II + version to anyone who already has Sargon II Chess and had 
purchased one of his character sets. Just send him a tape plus 4 * 27¢ stamps 
to cover postage costs. I can guarantee that it improves the game dramaticly. 


That was about it. I make no apologies for our unorganised form of meetings. 
I simply provide the time, place and refreshments, and the members make the 
meeting whatever they want it to be. Everyone seems to enjoy it. 


Ed Richardson. 


COMPUTER CLINIC 


Carl Nielsen offers fast turnaround for repairs to microcomputers of all 
types including OSI at his Computer Clinic, 2 Forestlea St, Bracken Ridge, 
QLD 4017. Carl has twelve year's experience in the computer field. 


Basic charge is $50 plus parts, however if extensive repairs are required 
the hourly rate is $20. Computer Clinic will also install modifications 
at a basic cost of $35. Phone Carl 


EPSON PRINTER BUFFER 


G.L. Wragg of offers a 32k or 64k memory 
board for the Epson MX-80 or MX-100 printers. The board plugs into the 
auxiliary interface connector inside the Epson without modification. 


The advantage of such a system is that the microcomputer can dump the 
printer information into the buffer and then continue with other tasks while 
the board takes over the printing task. In the hobby field, the feature is 
not so important because time is usually not a problem. However for business 
use, a printer buffer would be a necessity. 32k costs $188 and 64k is $275. 
For more information, phone between 6 and lOpm. 


MORE FROM THE WEST 
by Wayne Geary 


In Vol.3 No,2 there was a software review for Galaxia, I have modified a 
Cl version for my C2 and learnt a few things in the bargain, To change the 
speed alter location #04F0O which is normally set at #05. #01 to #09 give a 
good range of speeds, Note: #00 is DEAD slow, 


Since my previous letter in Vol.3 No.2 I have written an Adventure game 
based on Star Wars, It runs in 16K and has 37 rooms/sections though some have 
the same name and are therefore not obvious, 


I have just written a ROMable Auto Line program for BASIC programs which 
not only detects when to add a line number but will also retain the old line 
number if the last line was cancelled by a '@', Auto-line hooks into the input 
routine, is available directly after a cold start and can be turned on and off. 
Line numbers can be reset to default values which are: first line = 100 and 
increment = 10, by ConTRoL-S, This routine requires 2 bytes in DABUG to be 
changed or Auto-line will not work when DABUG is enabled. Auto-line with 
initialisation requires 1/4K ot memory. Anyone enquiring about either PRINT AT 
or AUTO-LINE will receive both as I am organising an assembler listing with 
both routines on it. The price is the same at $1.00 to cover costs. 


I have put together, on paper, a number of changes I have made to the 
Extended Monitor, These include:- 


1. A new start for EXMON which clears the screen (using the DABUG routine), 
sets the display to 64 characters wide, and put a heading onto the 
screen, 

2. Further mods to the start of EXMON to provide some extra space to modify 
the Disassembly routine. 

3. A modified Disassembly routine which gives 27 lines at a time and no 
spaces between each group of lines, My printer (an Anadex DP8000) cancells 
all input since the last 'Return' if no input is received for 10 seconds. 
The routine ensures no data is lost. 

4, A space (9 in fact) between the hex bytes and the mnemonics to provide 
room to put in labels by hand later. 

5. A new routine in place of the 8 byte hex dump ('Z' command) to provide a 
much needed block comparison with printout of any variations which are 
found, 

6. A routine called by the 'U' command which automatically downloads the 
Assembler/Editor from ROM to RAM, clears the screen, puts a heading on the 
screen and jumps to the Assembler, 

Three bytes in areas other than those covered in the above must be changed 
to accomodate the changes to the start of EXMON and these are covered in 
the listing of the routine, 


A listing of the changes I have made to the Extended Monitor is available 
from me, my address is 83 Second Ave, Rossmoyne, W.A. 6155, please enclose 
$1.00 to cover postage etc. 


I am still making mods to my extended BASIC and as well as the PRINT AT 
and the AUTO LINE mentioned above I also have a DELete function which deletes a 
sequence of lines (particularly useful when you are using OSUG's BASIC4 and © 
have a utility on top of your program). The DELete command has about one page 
of BASIC] ROM altered and requires only 63 bytes external to the BASIC ROMs, it 
is in place of the LET command, I am also working on modifying a M/C line 
renumberer to run in ROM, using about 80 bytes less and callable from BASIC by 
ConTRoL-R. 


THE BEGINNING MACHINE LANGUAGE PROGRAMMER....Part 7 
by David Dodds 


The most commmon technique for diverting the flow of a program is to use 
one of the conditional branches. Sometimes the diversion is outside the range 
of a branch instruction and other methods must be used, Multiple branching 
(branching to another branch) is one technique which can be used but is not 
usually very practical. This month I propose to explore 2 other methods for 
controlling the flow of a program, 


The 6502 allows branching of any length (up to the addressing limits of 
the processor) with the JUMP instruction, The mnemonic for JUMP is JMP. JMP 
1s most often used in the absolute addressing mode which is analogous in 
operation to GOTO in BASIC. In this mode the two bytes following the JMP 
opcode specify the value which is to be loaded into the program counter, If 
for example the instruction JMP $FEOO was processed then the program counter 
would be set to $FEOO resulting in a jump into the ROM monitor, 


There is however a less commonly used form of the JMP instruction which 
uses INDIRECT addressing. JMP is the only instruction available in indirect 
mode, The two bytes following the JMP opcode still specify an absolute address 
but this is the address where the value for the program counter is stored, 


In assembly language an indirect jump is written as 
JMP (address) 
The process cannot be legally written in BASIC but would best be expressed as: 
GOTO( PEEK(A)+256* (PEEK(A+1) ) 


The Superboard enters many of its routines such as SAVE, LOAD and CONTROL 
C using indirect jumps through the monitor ROM. SAVE for example is entered 
via the instruction JMP ($0220). 
This feature makes it very easy to replace the standard system routines with 
user written routines, Unfortunately this facility is not available on 
standard C2 and C4 OSI computers, 


Another common program control device is the subroutine call. Subroutines 
are an important part of a programming language and they are particularly 
important in assembly language. 


In BASIC subroutines are called with GOSUB and terminated with RETURN. In 
assembly language the mnemonics JSR (Jump to SubRoutine) and RTS (ReTurn from 
Subroutine) perform the same function. 


JSR is a three byte absolute mode instruction, Notice that the primary 
task of JSR is jump. However since the jump is to a subroutine the return 
address must be recorded for resetting the program counter when an RTS is 
executed, 


The 6502 uses the stack to record return addresses, Since the program 
counter is pointing at the next instruction once the JSR data has been read, 
the CPU simply PUSHes this 2 byte value onto the stack before writing the 
subroutine address into the program counter. On encountering an RTS the CPU 
PULLs the top two bytes of data from the stack and loads them into the program 
counter, 


One problem which can arise in using subroutines is that because there is 
only one stack, both the system and the programmer must share it. There is no 
way that the CPU can check whether the data it pulls is the correct address. 


Many a program has crashed because data PUSHed onto the stack after a 
subroutine call has not been PULLed before an RTS is performed, Likewise 
crashes occur because return addresses have been PULLed by a subroutine causing 
the CPU to read incorrect data into the program counter, 


Despite its dangers the subroutine remains an extremely powerful tool, 
Subroutines are most commonly used where the same operation needs to be 
performed at various places throughout a program, These programs then only 
need be written and tested once but may be used repeatedly, 


When writing subroutines for machine language applications it is important 
to keep them simple. Avoid performing several tasks within a routine as this 
will lessen its usefulness, It is far better to write two or more simple 
routines which you can reuse, rather than one longer one which you will never 
use again, 


There are many useful subroutines in the 65V monitor and BASIC-IN-ROM 
chips. Typically routines available include input, output, code conversion, 
interface and arithmetic processing, Many of the books available give details 
of what can be used, These routines work! Since there is no point in 
re-inventing wheels it makes sense to use them, 


The following routines are especially handy and should be used freely to 
make your programming easier: 


SFFEB :-Calling this routine allows you to input a character from either 
tape or the keyboard depending on the (BASIC) load flag, The routine uses 
both index registers and the accumulator so if you need any of the values 
in them save them before making the call to $FFEB. The character is 
returned to you in the accumulator, 

SFEED :-the keyboard part of SFFEB 

$A357 :-This is the fill-the-input-buffer-until-carriage-return routine, 
Characters are obtained via $FFEB and stored from $13 onward. All system 
conventions such as auto repeat, backspace etc apply. The final carriage 
return is converted to a null (00) in the buffer. 


OUTPUT 

SFFEE :-This routine sends whatever is in the accumulator to the screen 
(and to tape if the save flag is set). 

SBF2D :-is used by SFFEE to output the accumulator to the screen, Auto 
carriage return, line feed and screen scroll are generated automatically 
as required, 

SA8C3 :-BASICS' message printer routine, Set the accumulator with the low 
byte of the absolute address of the start of your message, set Y with the 
high byte and call this routine to print it. The message must end with a 
null, 


Modern developments in programming theory place a heavy emphasis on 
structured programming and top down design. As a result the subroutine has 
become more important. It 1s now commonplace to see the main line of a program 
consisting of very little more than a series of subroutine calls. 


The following simple program demonstrates the point: 


10 :TV TYPEWRITER PROGRAM 10 -TV TYPEWRITER PROGRAM 


20 * = $0222 20 0222 * = $0222 
30 MESAGE = SA8C3 30 A8C3= MESAGE = SA8C3 
40 READKY = SFEED | 40 FEED= READKY = SFEED 
50 ECHOIT = SBF2D : 50 BF2D= ECHOLIT = SBF2D 
60 LDY #$02 -60 0222 A002 LDY #$02 
70 LDA #$32. 70 0224 A932 LDA #$32 
80 JSR MESAGE 80 0226 20C3A8 JSR MESAGE 
90 LOOP JSR READKY 90 0229 20EDFE LOOP JSR READKY 
100 JSR ECHOIT 100 022C 202DBF JSR ECHOIT 
110° JMP LOOP 110 022F 4C€2902 JMP LOOP 
120 »BYTE SOD 120 0232 OD oBYTE SOD 
130 BYTE 'TV TYPEWRITER' 130 0233 54 »BYTE 'TV TYPEWRITER' 
140 ~BYTE $0A,SOD 130 0234 56 
150 .BYTE 'READY',$OD — 130 0235 20 
160 BYTE $0A,$0A,0 130 0236 54 
130 0237 59 
130 0238 50 
130 0239 45 
In case you haven't got the 130 023A 57 
general idea, lines 60 to 80 130 023B 52 
print a message on the screen, 130 023C 49 
then the loop part of program 130 023D 54 
waits for you to press a key and 130 023E 45 
then writes the character to the 130 023F 52 
video ram before jumping back to 140 0240 0A ~BYTE $0A,$0D 
get the next character. 140 0241 OD 
150 0242 52 »BYTE 'READY' ,$OD 
Over the next few months I 150 0243 45 
plan to develop with you a series 150 0244 41 
of subroutines which will 150 0245 44 
eventually come together to form 150 0246 59 
a graphics composer, 150 0247 OD 
(160 0248 OA -BYTE $0A,S0A,0 
160 0249 OA 
160 024A 00 


DEAR PAUL 


Q. I have installed a disk drive motor switch (Dodd's type) and find that 
frequently the drive motor switches itself on even though nothing has accessed 
the drive (eg. when the system is waiting an input from the keyboard), What 
could be the possible reasons for this? Note: I am using a Superboard with a 
Tasker: Buss expansion system, 

A. When I had a Tasker Buss system I noticed this effect, however now that I _ 
have a Rabble board this never happens, I assume then, that for some reason 
the Tasker disk controller board occasionally thinks that something has 
accessed $C000 which will turn the motor on, or my motor control switch 
occasionally triggers itself; why, I don't know. This effect never caused any 
problems, so I suggest that you either live with it or try building Bill 
Chilcott/Ray Gardiner's motor control circuit from the Rabble board manual. 


Q. Is there a simple way to load BASIC programs from tape to disk using OS65D 
V3.2¢ | 

A, In theory, yes. Boot up, enter BASIC and type DISK!"I0 O01" (no carriage 
return). Press play on your recorder and wait for the leader (the continuous 
tone) then press RETURN. The software should load until the 'OK' message and 
'SN ERROR' will appear. The loading will stop (no need to press SPACE). Your 
problem is converting the cassette software to disk (all the pokes and so on 
will need to be changed)! 10 


Q. Where does the standard line printer interface live on the OSI address map? 
I'm currently using the ACIA (device #1) but wish to claim this for use with a 
modem, and restore the printer to a PIA (device #4), 

A. OSI's device #4 is a card which plugs into the 16 pin I/O bus. This card 
costs about $200, so I assume you don't want to use it! George and I at 
COMP-SOFT use a 'standard' COMP-SOFT device #4 driver with a PIA at location 
$c004, Port A is used for the printer data lines (PAO-PA7) PBO is used for the 
strobe, and PBl for the busy line, : 

Additions to the DOS are: 


249F 8DO4CO STA $C0O04 
24A2 CEO6CO DEC $C006 
24A5 EEO6CO INC $C006 
24A8 ADO6CO LDA $C006 


24AB 2902 AND #$02 

24AD DOF9 BNE $24A8 

24AF 60 RTS 

And in your BEXEC*: Continued 
page 14 


xxx PI=49156:POKEPI,255:POKEPI+3 ,4: POKEPI+2,1:POKEPI+3,4:POKEPI+2,1 
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DISK FILES 
by Graeme Reardon 


So! You have finally tired of all those easy to get at disk games and have 
decided to get dinkum and write yourself a useful program to store and retrieve 
information, Well that should be super simple. After all you managed to do it 
on cassette and only had one page of instructions, 


If you are like me, you then discovered the users manual is rather 
difficult to follow, and it certainly does not teach you (by itself) how to 
read and write files, So here is a simple program to show how to write some 
meaningful data to a file on disk and then retrieve it. 


However, we must use the CREATE utility to create a file called (in this 
example) "XXXX"", You can change the name of your file if you wish but change 
line 10 in the program, 


Now run CREATE again and create a file to store the program listing that 
you are going to type in. You can also PUT the program onto the DATA file so 
that there is something for the progrram to look at when it is setting up the 
file initially but make sure that you answer (YES) in line 40 the first time 
you run the program. 


Now run the program called "CHANGE". CHANGE will allocate space for your 
disk buffers so just answer the questions as prompted. Much of the above is 
unnecessary if you use COMP-DOS 1.2 - see notes in program, You could add more 
lines into the program at lines 130 to 151 as long as the total of each record 
did not exceed 128 in this case, For example "INFORMATION 1" could be changed 
to "NAME?" and "INFORMATION 2" changed to "ADDRESS?", A little bit of thought 
is required here and you will see that each word of information is added to the 
last (in line 150) before putting them to disk, The spaces between are to 
format for output. 


There are many possibilities for expansion of this program including 
editing, sorting and updating - perhaps some of these could be discussed in 
future articles. 


11 Next page please 


1 REM DEMO FILE PROGRAMME by G. REARDON 


10 
20 
25 
27 
28 
29 
30 
40 


DISK OPEN,6,'XXXX"" :REM XXXX= FILE NAME 
DISK GET,0 

INPUT#6,HMS :REM NUMBER OF RECORDS 
HM=VAL(HMS$ ) 

PRINT"There are ";HM;"Entries in the file" 


PRINT: PRINT: PRINT 
INPUT"Do you wish to create a new file";Y$ 
IF ASC(Y$)<)89THENIO 


50 DISK GET,O 

60 HMS="'0"" 

65 HM=0: REM NO RECORDS IN FILE 

70 PRINT#6,HMS 

80 DISK PUT 

85 PRINT: PRINT:PRINT 

90 PRINT" 1 Input information" 

92 PRINT''2 Print out information"; 


95 

100 
110 
115 
120 
130 
140 
150 
151 
160 
170 
180 
182 
183 
185 
187 
200 
201 
202 
205 
210 
220 
230 
240 
250 
260 
270 
280 
300 
310 
400 


410 : 
420 : 
430: 


440 


460 


470: 
480 : 


490 
500 


450 


INPUTQ : IFQ=2THEN200 


REM INPUT ENTRIES 
HM=HM+1 
PRINT:PRINT: PRINT'Type EXIT to finish entries" 
DISK GET,HM 
PRINT: PRINT: INPUT" INFORMATION 1';A1S:IF A1S="EXIT"THEN182 
INPUT" INFORMATION 2';A2S 
RES=A1S+"' "+A2S: REM COULD ADD MORE FIELDS - up to 
REM maximum of 128 characters per record 
PRINT#6 , RES 
DISK PUT 
GOTO110 
HM=HM-1 :HM$=STRS$ (HM) 
DISK GET,0 
PRINT#6,HMS: REM NEW NUMBER OF RECORDS 
DISK PUT 
REM PRINT OUT TO REQUIRED DEVICE 
PRINT: PRINT: INPUT"Do you want printout to a printer";Y$ 
DV=2:1F ASC(Y$)=89THEN DV=1 
REM (DV=1) IS CASSETTE PORT OR PRINTER AT THAT PORT 
IF HM=OTHENPRINT:PRINT:PRINT#DV,"No information in file':GOTO300 
FOR NO=1TOHM 
DISK GET,NO 
INPUT#6, ROS 
PRINT: PRINT: PRINT#DV ,ROS 
PRINT#DV, 
NEXT 
PRINT: PRINT: PRINT#DV,"End of information in files" 
DISK CLOSE, 6 
END 
: To change record length add 15 POKE12042,48:POKE12076,6 
See earlier article in KAOS 
Add line 290 POKE12042,24:POKE12076, 7 
Check these pokes for 8 inch systems 
If using COMP-DOS 1.2 add the following lines 
: 5 DISK!"BS 06": CLEAR 
: 305 DISK!"BR" | 
I;f you have 1.2 you do not have to run 'CHANGE' but you. 
: still create a Data file using DISK!"CR XXXX,YY" 
: XXXX= Any file name. YY= Number of tracks 
then DISK!"ZE XXX" 
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NEW EX MON DISASSEMBLER (Cassette Version) 
by Gerry walker 


1FB7 201C1B JSR S1BI1C 
1FBA A5DC LDA SDC 
1FBC 85D5 STA SD5 
1FBE A5DD -LDA SDD 
1FCO 85D6 STA SD6 
1FC2 20071B JSR $1B07 
1FC5 A20A LDX #SOA 
1FC7 8E131A | STX $1A13 
1FCA A204 LDX #$04 
1FCC 20511C JSR $1C51 
LFCF CA DEX 

1FDO DOFA BNE S$1FCC 
LFD2 20821A JSR $1A82 
1FD5 20B319 JSR $19B3 
1FD8 20941A JSR $1A94 
LFDB 85D5 STA $D5 
1FDD 84D6 STY SD6 
1FDF 38 SEC 

1FEO A5SDE LDA SDE 
1FE2 E5D5 SBC S$D5 
1FE4 A5DF LDA SDF 
1FE6 E5D6 , SBC SD6 
1FE8 BOD8 BCS S1FC2 
1FEA 20071B JSR $1B07 
1FED A904 LDA #$04 
1FEF 8D131A STA $1A13 
1FF2 60 RTS 


The above program is a modification of Frank Halley's new disassembler 
(KAOS Vol.3 No.2) for use with the cassette version of the ExMon, I have found © 
it to be such a vast improvement when printing disassemblies that I thought you 
may like to publish it as other readers might find it of use too, 


It is located in the space occupied by the Z routine with ExMon at 1800H 
and operates in the same way as the original except that I have zdded the 
facility to specify separately the spacing before the start of code and between 
the code and mnemonics, the spacings are set by locations 1FC6 and 1FCB. 


If you wish to retain the Z routine for use with the improved Search 
program recently published, as I have, then you will need to relocate it 
elsewhere, such as at OFB7 or in EPROM. 


Maybe some enterprising programmer will come up with a way of fitting them 
both into 2K. 
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FOR SALE 


2 assembled and tested 8K static RAM cards for the Tasker Buss, without RAM, 
$20.00 ea. I will strap the cards for any block of memory requested in the 
upper or lower 32K boundaries, 

1 Geoff Cohen floppy disk controller fully assembled but no chips on it, not 
tested, $10 or offer. 

1 Geoff Cohen Cl to C4 video board assembled with sockets , not tested, no 
chips, $20 or offer. | 
Contact David Tasker 
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Dear Paul Continued from page 10 


Q. I have a printer connected to my Tasker I/O board at address $E004., The 
printer works perfectly in the DOS, however I cannot get the DOS to boot unless 
the printer is switched on, Why? 

A, I can think of two reasons, neither of which I can be sure of being the 
problem. Firstly SEO00 - SE800 is the location for the colour RAM on OSI 
machines, Perhaps the DOS tries to clear these location, but finds that it 
can't, Secondly, OSI may have an IO device at this address and this causes 
your problem, Either way, I can not be sure, but I have never heard of this 
problem before, 


Q. What does the 'WAIT' instruction do? 

A. WAIT is generally used to poll (or check) an I/O port location, It has two 
forms: 

i) WAIT I, J 
ii) WAIT I, J, kK 
The first form is used the most, I is a memory location, J and K are integers 
between 0 and 255, The first form peeks memory location I, ANDs the result 
with J and keeps doing this until the result is not zero, For example, if you 
had an input port at location $C004, and had a push button connected to bit 0 
(the first bit), and you wanted to pause until the button was pressed the 
instruction to use would be: 


WAIT 49156,1 


The second form peeks address I, exclusive ORs this with K and ANDs the result 
with J. This happens until the result is not zero. I have never used this 
form of the instruction, 


Q. What are the differences between disk BASIC and ROM BASIC? 

A, Disk BASIC (OS65D) does not have the reserved words LOAD and SAVE, and 
instead has the words DISK and EXIT. The EXIT command causes the computer to 
leave BASIC and enter the DOS (disk operating system). Disk is used to send 
commands to the DOS via the DISK! "doscmd" statement, and to handle file 
commands, DISK OPEN, DISK CLOSE, DISK GET, DISK PUT. The disk BASIC also has 9 
digit real numbers instead of 6 digits and of course all the Peeks and Pokes 
are different, For more information see the BASIC REFERENCE MANUAL by OSI. 


Here are some extracts from a letter sent to me by Mr Ian Davidson regarding 
data transmission and RS232., 


"T would like to suggest some expansions to your answers in KAOS Vol.3 No.2 
which should clarify some aspects of data transmission, 


FULL DUPLEX: The ability to transmit in both directions simultaneously. 
HALF DUPLEX: The ability to transmit in both directions but not at the same 


time," 


He then goes on to explain 'echo-plex' and to explain why some systems use Full 
Duplex and why others use Half Duplex. He also says something about RS232: 


"...RS232 is not a data transmission standard, but rather a serial data 
interface standard for connecting to data communication equipment (modems). 


The transmission standards are defined elsewhere," 


Thank you Ian Davidson, 
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Hardware for the Tasker Buss 


A 24K memory board, 


chips. 


and 2716 EPROMs., 
Power consumption approx. 


2W. 


anticipate a large demand for the board as many people 


memory or a Rabble board, 


I will not be getting plated through boards, 


the board requires soldering on both sides and sockets 


on top of the board, 


I will not charge for assembly at 


standard size , that can take 12 assorted types of 2K 
This board has been tested at 1MHz for 6116 CMOS RAM, 2128 static RAM 
The board may have a combination of any of these chips. 

The board is double sided but as I do not 


will have established 
Because 
are difficult to solder 
this time, I will 


assemble and test each board with all components and provide sockets for the 


Memory « 


Notes and circuits with strapping applications are available, please send $1 


cover postage, 


Thanks to David Anear the 16 pin I/O buss for the Tasker Buss (refer circuit 
At the moment the only board we have that will 


KAOS Nov. 


1982) is finished. 
plug into it is the new EPROM programmer, 


being prepared and will be available soon, 


Contact David Tasker 


The board is $25, parts and sockets $17, 
assembly charge of $20 after the lst March, 


posta 


ge $2, There will be an 


Limit of 2 boards per customer, 


Co 


Notes and application hints are 


R65C02, R65C102, R65C112 Microprocessors 


INSTRUCTION SET ALPHABETIC SEQUENCE 


ADC 
AND 
ASL 


BBR 
BBS 
BCC 
BCS 
BEQ 
BIT 

BMI 

BNE 
BPL 
BRA 
BRK 
BVC 
BVS 


(1) 


CLC 
CLO 
(ol 
CLV 
CMP 
CPX 
CPY 


(2) 


(2) DEC 


DEX — 


DEY 


INC’ 
INX 
INY 


JMP 
JSR 


(2) 


LDA 
LDX 
LDY 


(2) 


LSR © 


EOR 


Add Memory to Accumulator with Carry 
"AND" Memory with Accumulator 
Shift Left One Bit (Memory or Accumulator) 


Branch on Bit Reset 
Branch on Bit Set 
Branch on Carry Clear 

Branch on Carry Set 

Branch on Result Zero 

Test Bits in Memory with Accumulator 
Branch on Result Minus 

Branch on Result not Zero 

Branch on Result Plus 

Branch Always 

Force Break 

Branch on Overflow Clear 

Branch on Overtiow Set 


Clear Carry Flag 
Clear Decimal Mode 

Clear Interrupt Disable Bit 

Clear Overtiow Flag 

Compare Memory and Accumulator 
Compare Memory and Index X 
Compare Memory and Index Y 


_ Decrement Memory by One 
Decrement Index X by One 
| Decrement Index Y by One 


“Exclusive-OR” Memory with Accumulator 


Increment Memory by One 
Increment Index X by One 
| Increment Index Y by One 


Jump ic New Location . 
| Jump to New Location Saving Return Address 


Load Accumulator with Memory 
Load index X with Memory 
Load Index Y with Memory 
Shift One Bit Right (Memory or Accumulator) 
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(2) 


(1) 
(2) 


(1) 


(1) 
(1) 


NOTES: 


(1) New Instruction 
(2) Previous Instruction with additional addressing mode(s) 


No Operation 


"OR" Memory with Accumiator 


Push Accumulator on Stack 
Push Processor Status on Stack 
Push X Register on Stack 

Push Y Register on Stack 

Pull Accumulator from Stack 

Pull Processor Status from Stack 
Pull X Register from Stack 

Pull Y Register from Stack 


Reset Memory Bit 
Rotate One Bit Left (Memory or Accumulator) 
Rotate One Bit Right (Memory or Accumulator) — 


Return from | 


Return from Subroutine 


Subtract Memory from Accumulator with Borrow | 
Set Carry Flag 

Set Decimal Mode 

Set Interrupt Disable Status 
Set Memory Bit 

Store Accumulator in Memory 
Store Index X in Memory 
Store Index Y in Memory 


Store Zero 


Transfer Accumulator to Index X 
Transfer Accumulator to Index Y 
Test and Reset Bits» 


Test and Set 


Transter Stack Pointer to Index X 
Transfer Index X to Accumulator 
Transfer Index X to Stack Register 


Function 


nterrupt 


Bits 


Transfer Index Y to Accumulator 


R65C00 MICROPROCESSORS 


3 
32 
> 

a 

> 
e& 
> 
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FEATURES 
e CMOS silicon gate technology e Use with any type of speed memory 
e Low Power (4MA/MHz) e Eight-bit Bidirectional Data Bus 
e Downward software compatible with R6502 e Addressable memory range of up to 64K bytes 
—Twelve additional instructions e “Ready” input 
—Two new addressing modes e Direct Memory Access capability 
e Single 5V +20% power supply e Memory Lock Output 
e Eight bit parallel processing e 2MHz, 3MHz, and 4MHz versions 
e Decimal and binary arithmetic e Choice of external or on-chip clocks 
e True indexing capability e On-the-chip clock options 
e Programmable stack pointer —External single clock input 
e Interrupt capability —Direct Crystal Input (+ 4) 
e Non-maskable interrupt 
Pies ae 2 3 4 5 6 7 8 9 
2) 
# BRK | ORA ORA | ASL 
0 | Implied | (IND. X) zp zP 
17/26 23|25 
BPL | ORA | ORA ORA | ASL 
1 | Relative| (IND), Y | (IND) zP,x | ZP, x 
227/25 | 25 24] 26 
JSR | AND AND | ROL 
2 | Absolute} (IND, X) zp zp 
36/26 3] 25 
AND BIT AND ROL 
3 | Relative| (IND), Y | 2P,x | ZP.x | ZP.x 
2 2712 5° 7 241/24 ]|26 
AT! | EOR LSR 
4 | Implied | (IND, X) zF 
161/126 2 5 
BVC | EOR EOR | LSR 
5 | Relative| (IND), Y ZP,xX | ZP,X 
22°|2 5 24126 
| RTS | ADC STZ }| ADC | AOR 
6 | Implied | (IND. X) zP zP zP 
16 | 2 6t 23] 2 3t| 2 5 
BVS | ADC | AOC | STZ | ADC | ROR 
7 | Relative! (IND), Y | (IND) zP,x | ZP,xX | ZP.X 
2 2°) 2 St }2 St 2442 4t] 2 6 
BRA | STA Sty | STA | STX | SMBO| DEY | BIT | TXA STY | STA BBSO 
8 |Relative| (IND. X) *ZP zp zp ZP | Implied | IMM | Implied ABS | ABS zp 
23] 2 6 23/23/23 ]725]1 2] 22 3 5" 


2 3 4 3.4 
2 


1 
TXS 
, Implied 
3 5 1 


BCC | STA | STA sty | STA | STXx 
9 | Relative| (IND), Y | (INO) zP, x zP.Y 
2 2°| 2 6 2 4 24 


LOY LOA LOX 
A IMM (IND, X) | IMM 
22 2 6 


ny 
o 

33 

@ < wy 6 


~ 
% 
—_ 
% 


N 
& x < w P< 
aN - | mie N 
Vo No a 
— ele a Cc 
36g Ro 
a2 < KX} wo x 
.@) 
[ oe 
< 
CGE 
a’S 
°< 


LOA 
B | Relative! (IND), Y | (INO) 


LDA TAX 

IMM | Implied 

22 1 2 
TSx 

BS, implied 

1 2 


CPY CMP CPY DEC CPY DEC 6B 

C | IMM | (IND, X) 2p zP ABS aes | zP 
22 2 6 2 3 2 5 3 4 3 643 5° 
BNE CMP DEC BBSS 

D | Relative} (IND), Y ZP,&x 2P 
22°) 2 5° 2 6 12 3 «5°° 
SBC SMB6 SBC NOP SBC BBS6 

E zP zP IMM_ | Implied A8S 2P 
2 3t 2 5 2 2t| 1 2 a 4t 3 $s" 
SBC SBC SMB7 SBC SBC BBS7 

F (IND) ZP, X zP ABS, Y ABS, X 2P 
2 Sf 2 4f 2 5 3 4°f 3 4°f 3 «°° 

0 1 2 3 4 5 6 7 8 9 A 8 Cc OD E F 

0 
TtAdd 1 to N # in decimal mode. 
BRK —OP Code *Add 1 to N if page boundary is croseed. 
— New Oocode 0 | Implied | —Addressing Mode **Add 1 to N if branch occurs to same page: 


1 7 | —lInstruction Bytes; Machine Cycles Add 2 to N if branch occurs to different page. 


